home *** CD-ROM | disk | FTP | other *** search
/ Wayzata's Best of Shareware PC/Windows 1 / Wayzata's Best of Shareware for PC-Windows - Release 1 - Wayzata Technology (1993).iso / mac / WINDOWS / MISCUTIL / IS114 / ICOSHOW.TXT < prev    next >
Text File  |  1992-09-29  |  49KB  |  1,273 lines

  1.  
  2.  
  3. Documentation of Program IcoShow
  4.  
  5.  
  6.  
  7.        Version             1.14
  8.  
  9.        Date                September, 28th 1992
  10.  
  11.  
  12.  
  13.        Register at         Harald Pitro
  14.                            Hermann-Wuensche-Strasse 11
  15.                            Germany - O - 8705 Ebersbach / Sachsen
  16.  
  17.        Phone/Fax           +49-3586-5186
  18.        CompuServe          100024, 2662
  19.  
  20.        Registration for    $35 (incl. shipping and printed documentation)
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                      Table of Contents
  29.  
  30.     1. Overview                                           
  31.     2. System Requirements and Limits                     
  32.     3. Start and Command Line                             
  33.     4. INI file                                           
  34.          4.1 Application [IcoShow]                        
  35.          4.2 Application [Groups]                         
  36.     5. Menu Commands                                      
  37.          5.1  File Menu                                   
  38.          5.2  Icons Menu                                  
  39.               5.2.1 Copy / Move                           
  40.               5.2.2 Rename / Edit                         
  41.               5.2.3 Select                                
  42.               5.2.4 Exclude                               
  43.          5.3  Options Menu                                
  44.               5.3.1 Edit with ...                         
  45.               5.3.2 Repair Icons                          
  46.               5.3.3 Save Settings                         
  47.               5.3.4 Quick Delete                          
  48.               5.3.5 Quick Search                          
  49.          5.4  Window Menu                                 
  50.          5.5  Help Menu                                   
  51.          5.6  Properties Menu                             
  52.     6. Dialog Boxes                                       
  53.          6.1  Open                                        
  54.          6.2  Print Icons                                 
  55.          6.3  Create Library                              
  56.          6.4  Select Icons                                
  57.          6.5  Exclude Icons                               
  58.          6.6  Edit with ...                               
  59.          6.7  Rename Icon                                 
  60.          6.8  Select Window                               
  61.          6.9  Registration                                
  62.          6.10 Print Order Form                            
  63.          6.11 About IcoShow                               
  64.     7. Status Line                                        
  65.     8. Hints for the use of IcoShow                       
  66.     9. Shareware Version                                  
  67.  
  68.  
  69.  
  70. 1. Overview
  71.  
  72. The  amount of present icons for Windows requires a simple
  73. management  and  the  possibility to  process  icons  from
  74. management, to group them by anyone and to write  them  to
  75. icon files or libraries.
  76.  
  77. IcoShow  searches for icons and libraries  with  icons  in
  78. selected drives and/or directories (in subdirectories also
  79. if wished) and shows the icons including their names. Each
  80. directory including icons becomes a new window. After  you
  81. have started IcoShow you can add directories at any time.
  82.  
  83. You  can copy or move icons from one window to another  by
  84. dragging  them with the mouse. If you minimize  a  window,
  85. all  selected  icons will be copied or moved  with  window
  86. icon.  If you wish to process only a part of the icons  in
  87. windows,  you can select/exclude icons by pattern  strings
  88. that matches the icon names.
  89.  
  90. You  can write the selected icons from one window  or  all
  91. windows to a new library. In one library you can hold over
  92. 2,700  icons but if you write more than 1,200 icons  to  a
  93. library  this  library  can not be used  in  another  icon
  94. manager or program manager. You can exclude duplicates  of
  95. icons while writing them to a library.
  96.  
  97. You  can  choose  an  icon editor to  process  icons  from
  98. IcoShow  directly.  If  the editor chosen  is  capable  of
  99. command   line  processing,  the  icon  will   be   opened
  100. automatically and presented for editing.
  101.  
  102. If  you wish to install icons in program manager, you need
  103. only to drag them from the IcoShow window to the window of
  104. the program manager using the mouse.
  105.  
  106. Icons or all icons selected in a window can be deleted  by
  107. the DEL key (you cannot delete icons within libraries). If
  108. you are an experienced user, you can delete them simply by
  109. dragging  them  outside  of  screen.  Please  be  careful,
  110. IcoShow do not undelete icons!
  111.  
  112. Some  older icon files contains bugs (the program  manager
  113. shows you a truncated icon image). IcoShow lets repair you
  114. this bug.
  115.  
  116. You   can   print  icons  with  any  matrix,  ink-jet   or
  117. laserprinter  (postscript also). You  may  also  print  in
  118. color if your printer can handle the output.
  119.  
  120. IcoShow  writes the current status of the options and  his
  121. desktop in the file ICOSHOW.INI.
  122.  
  123. In  a  status line you can see the most important  options
  124. and some informations about the processed icons.
  125.  
  126. If  you need help, press F1 at any time. IcoShow will  try
  127. to find the proper help for you.
  128.  
  129.  
  130. 2. System Requirements and Limits
  131.  
  132. IcoShow  will  run under Windows 3.0 and 3.1  in  standard
  133. mode  as well as in enhanced mode. It will not run in real
  134. mode because there is not enough heap space.
  135.  
  136. IcoShow  shows the proper image for the display from  each
  137. icon.  If  you  have a monochrome card, you will  not  see
  138. icons   that  only  contain  color  images.  But   IcoShow
  139. processes the icon files with all images!
  140.  
  141. The  amount  of  icons you can process  depentend  on  the
  142. amount  of  displayed  windows. IcoShow  can  display  and
  143. process up to 16,384 icons.
  144.  
  145. Look at the dialog box "About IcoShow" (Help Menu) to  see
  146. the  use  of heap and resources. Check these informations.
  147. If  you  see that "Free Heap" is very small, close windows
  148. to  free  local  heap.  An overflow in  local  heap  stops
  149. IcoShow immediately.
  150. If  there  are no more windows or dialog boxes  displayed,
  151. you have too many opened windows.
  152.  
  153. IcoShow  supports libraries of types DLL/NIL/ICL.  IcoShow
  154. will  warn  you if you try to write more than 1,200  icons
  155. into  a library. You can save over 2,700 icons within  one
  156. library  but this library will not be applicable by  other
  157. icon managers (program manager also).
  158. 3. Start and Command Line
  159.  
  160. You  will  usually  start  IcoShow  without  command  line
  161. arguments. If you want to use command line processing, the
  162. syntax is:
  163.  
  164.  
  165.     ICOSHOW [-s] [Directory ...]
  166.  
  167.  
  168.   -s       Include subdirectories (you can type /s for -s).
  169.   
  170.   -d       Don't use BWCC.DLL
  171.   
  172.   Directory  Drive and path including icons possibly.
  173.  
  174.  
  175. Example :       ICOSHOW -s c: d:
  176.  
  177. searches  for  icons the drives 'c'  und  'd',   including
  178. all subdirectories, and shows all directories with icons.
  179.  
  180. Hint:   If  you start IcoShow with command line arguments,
  181.         the  saved  desktop in INI file  will  be  ignored
  182.         (see also below).
  183.  
  184.  
  185.  
  186. 4. INI file
  187.  
  188. IcoShow  saves an INI file with the status of the  options
  189. and  the  last desktop. So you can continue with the  same
  190. environment at the next session. The key names must follow
  191. the  application names [IcoShow] and [Groups].  Upper  and
  192. lower case is the same.
  193.  
  194.  
  195. 4.1 Application [IcoShow]
  196.  
  197. Example :
  198.  
  199. Application/Key                             Default
  200. [IcoShow]
  201. SaveSettings=1                              (0)
  202. SubDir=On                                   (Off)
  203. Libraries=Exe,Dll,Nil,Icl                   (,,)
  204. SearchNames=Off                             (On)
  205. LibName=c:\win\icons.dll                    (-)
  206. Run=imagedit                                (-)
  207. Repair=On                                   (Off)
  208. Tool=Move                                   (Copy)
  209. Rename=On                                   (Off)
  210. QuickDelete=On                              (Off)
  211. QuickSearch=On                              (On)
  212. Select=A*                                   (-)
  213. Exclude=AB*                                 (-)
  214. Minimize=On                                 (Off)
  215. Arrange=Tile                                (Cascade)
  216. BackColor=191,191,191                       (-)
  217. Window=0 0 640 480 3                        (-)
  218. Registered=Gustav Hackendahl                (-)
  219. Password=0815                               (-)
  220.  
  221. Enclosed  in  brackets are the default values  if  IcoShow
  222. does  not  find an INI file. You can change  the  settings
  223. while IcoShow is running (exception: "BackColor").
  224.  
  225.  
  226. Explanation of the example atop:
  227.            
  228. "SaveSettings=1"   IcoShow will save the settings  of  the
  229.                    options and his desktop on exit.
  230.  
  231. "SubDir=On"        If  you  add directories and/or drives,
  232.                    IcoShow   will  search  for  icons   in
  233.                    subdirectories also.
  234.  
  235. "Libraries=Exe,Dll,Nil,Icl"  IcoShow searches for icons in
  236.                    libraries also. If IcoShow searches for
  237.                    ICO   files   only,  this   key   reads
  238.                    "Libraries=,,,".
  239.  
  240. "SearchNames=Off"  Some  libraries contain names  for  the
  241.                    including  icons. If this statement  is
  242.                    "On",  IcoShow  will  search  for   the
  243.                    names.  If this option is "Off"  or  if
  244.                    icons  have no names, IcoShow will  use
  245.                    the  library  name  for  the  including
  246.                    icons.
  247.  
  248. "LibName=c:\win\icons.dll"    This statement contains  the
  249.                    full  name of the last written  library
  250.                    and  will be the default name  for  the
  251.                    next.
  252.  
  253. "Run=imagedit"     If  the  option "Rename"  is  "Off",  a
  254.                    double click with the mouse will  start
  255.                    the  icon  editor chosen  here  (or  in
  256.                    Option Menu). IcoShow appends the  full
  257.                    icon name and starts the program.
  258.  
  259. "Repair=On"        If  this  option is "On", IcoShow  will
  260.                    repair  bugs  in older  icon  files  on
  261.                    disk.  Bugs  in libraries will  not  be
  262.                    repaired.  IcoShow repairs bugs  always
  263.                    while running.
  264.  
  265. "Tool=Move"        Icons  will  be moved by dragging  them
  266.                    with the mouse.
  267.  
  268.                    If "Tool=Copy", icons will be copied.
  269.  
  270. "Rename=On"        If  this option is "On", a double click
  271.                    with  the mouse will open a dialog  box
  272.                    to  rename  the current icon.  If  this
  273.                    option is "Off", IcoShow will start the
  274.                    icon editor selected (see upon).
  275.  
  276. "QuickDelete=On"   If  you  press the Del key, the current
  277.                    icon (or all icons in current window if
  278.                    minimized)  will  be  deleted.  IcoShow
  279.                    will  prompts you to confirm  that.  If
  280.                    you  are  an experienced user, you  can
  281.                    delete  icons by dragging them  outside
  282.                    of  screen.  In this case IcoShow  will
  283.                    not  warn you. Please be careful.  Hold
  284.                    this  option "Off" until you  are  sure
  285.                    you want to delete icons.
  286.  
  287. "QuickSearch=On"   If  this  option is "On", you can  find
  288.                    icons  by names quickly. Type simply  a
  289.                    string.  IcoShow tries to  find  proper
  290.                    icons  in  the current window.  IcoShow
  291.                    searches  with each character you  have
  292.                    entered successively. If no proper icon
  293.                    names have been found, the string  will
  294.                    be deleted.
  295.                    You  can see the current string in  the
  296.                    status  line. Look at point  5.3.5  for
  297.                    more details.
  298.  
  299. "Select=A*"        Under this statement IcoShow reads  the
  300.                    current pattern used to select icons by
  301.                    names  for processing. The term  A*  in
  302.                    the  example  causes  to  display  only
  303.                    icons which names start with "A" in all
  304.                    windows.  You can process only selected
  305.                    icons (the term "*.*" processes all  of
  306.                    them)!
  307.                    This  entry  is  a  readonly.  You  can
  308.                    change  the  setting while  IcoShow  is
  309.                    running but it will not be saved in the
  310.                    INI file.
  311.                    For more details about this pattern see
  312.                    5.2.3.
  313.  
  314. "Exclude=AB*"      Similar   to  the  "Select"   statement
  315.                    IcoShow reads the current pattern  used
  316.                    to   exclude   icons  by   names   from
  317.                    processing.  This example  common  used
  318.                    with  "Select=A*" displays icons  which
  319.                    names  start  with the letter  "A"  and
  320.                    which names do not have the letter  "B"
  321.                    at second place.
  322.                    This  entry  is  a  readonly.  You  can
  323.                    change  the  setting while  IcoShow  is
  324.                    running,  but it will not be  saved  in
  325.                    the INI file.
  326.                    For more details about this pattern see
  327.                    5.2.4.
  328.  
  329. "Minimize=On"      This   statement  causes   IcoShow   to
  330.                    display windows minimized on create.
  331.  
  332. "Arrange=Tile"     IcoShow   displays  all  not  minimized
  333.                    windows  als  "Tile". "Arrange=Cascade"
  334.                    shows the windows as "Cascade".
  335.  
  336. "BackColor=191,191,191"   This   statement  contains   the
  337.                    background  color  for  the   displayed
  338.                    icons.  If it's missing, the background
  339.                    will   be   the  same  as  the   window
  340.                    background.
  341.                    You  can not change this setting  while
  342.                    IcoShow is running.
  343.  
  344. "Window=0 0 640 480   3"    This  statement  contains  the
  345.                    position  and  the size  of  the  frame
  346.                    window:
  347.                    position of the upper left corner (0,0)
  348.                    size of the frame window (640x480)
  349.                          style  of  frame  window     
  350.                                            1 - normal
  351.                                            2 - minimized
  352.                                            3 - maximized
  353.  
  354. "Registered=Gustav Hackendahl"    Here stands your name.
  355.  
  356. "Password=0815"    The  password you get from author after
  357.                    you register the program.
  358.  
  359.  
  360.  
  361. 4.2 Application [Groups]
  362.  
  363. Example:
  364.  
  365. [Groups]
  366. Group1=c:\windows3\icons                                 4
  367. Window1=10 10 100 100                                    
  368. Group2=c:\windows3        Minimize                       0
  369. Window2=20 20 100 100                                    
  370. Group3=c:\windows3\system          EXEDLLNILICL          0
  371. Window3=30 30 100 100                                    
  372. Group4=c:\windows3\tools                          Active 0
  373. Window4=40 40 100 100                                    
  374.  
  375. For  each  line Groupi there must be a Windowi  line.  Key
  376. words within the lines are separated with Space or Tab.
  377.  
  378. "Minimize"         This window will be shown minimized.
  379.  
  380. "EXEDLLNILLICL"    In  this window will be included  icons
  381.                    from  the  library types Exe, Dll,  Nil
  382.                    and Icl. This key word is empty if only
  383.                    icons from ICO files will be included.
  384.  
  385. "Active"           This  key word marks the current active
  386.                    child window.
  387.  
  388. "0"                The  last  value is the number  of  the
  389.                    current icon in the window.
  390.  
  391. The statement "Windowi" contains the position and the size
  392. of the "Groupi" window.
  393.  
  394.  
  395.  
  396. 5. Menu Commands
  397.  
  398. 5.1  File Menu
  399.  
  400. In  the  File Menu you can open directories to select  the
  401. icons  existing there, print selected icons, create a  new
  402. icon library, refresh a directory window or exit IcoShow.
  403.  
  404.  
  405. Open             If you choose this menu command, a dialog
  406.                  box  will open to allow you to browse for
  407.                  the directory and/or drive wanted and  to
  408.                  check whether subdirectories and/or  icon
  409.                  libraries  (Exe/Dll/Nil/Icl)  are  to  be
  410.                  included and whether IcoShow is  to  look
  411.                  for   and  display  icon  names  in  some
  412.                  libraries.
  413.  
  414.                  Hint :  If the directory chosen does  not
  415.                          exist,  you  will be prompted  to
  416.                          allow IcoShow create it.
  417.  
  418. Print Icons      This command prints the selected icons in
  419.                  the current window on selected paper with
  420.                  any matrix, ink-jet or laser printer. You
  421.                  may  also print in color if your  printer
  422.                  can  handle  the output.  The  number  of
  423.                  printed  icons per sheet depends  on  the
  424.                  printer's resolution.
  425.                  The  description of the  dialog  box  you
  426.                  find at chapter 6.
  427.  
  428. Create Library   Transfers the selected icons from  either
  429.                  the current window or all windows into  a
  430.                  library.  Supported  library  types   are
  431.                  DLL/NIL/ICL.
  432.  
  433.                  You  can  put more than 2,700 icons  into
  434.                  such a library. But if you intent to  use
  435.                  the  library later with Window's  program
  436.                  manager  or with some other icon manager,
  437.                  you  should  not include more than  1,200
  438.                  icons. IcoShow will issue a warning.
  439.  
  440.                  For more details see chapter 6.
  441.  
  442. Refresh Directory Choose this option from System  Menu  if
  443.                  you wish to read icons and libraries from
  444.                  current directory again. Use this if  you
  445.                  have changed the content of the directory
  446.                  with  a  file  manager while  IcoShow  is
  447.                  running.
  448.  
  449. Exit IcoShow     Use   Hotkeys  Alt-F4  to  exit   IcoShow
  450.                  directly.
  451.  
  452.                  If  the  option  Save  Settings  (Options
  453.                  Menu)  has  been selected,  IcoShow  will
  454.                  save  all  settings including desktop  in
  455.                  ICOSHOW.INI   within  the  directory   of
  456.                  IcoShow.Exe.
  457.  
  458.  
  459.  
  460. 5.2  Icons Menu
  461.  
  462. Use  this menu to determine the function of the left mouse
  463. button  and  to select the icons to be used. All  commands
  464. under this menu are ineffectual if you drag an icon to the
  465. program manager!
  466.  
  467.  
  468. 5.2.1 Copy / Move
  469.  
  470. Choose here if you want to copy or to move icons with  the
  471. mouse.
  472.  
  473. Copy             You  can  drag  specific icons  or  icons
  474.                  symbolizing a minimized window containing
  475.                  icons  to  a destination window with  the
  476.                  mouse.  Place cursor on icon, press  down
  477.                  the left mouse button, then drag the icon
  478.                  to  its destination and release the mouse
  479.                  button.
  480.                  If  this  option is checked, the  icon(s)
  481.                  will be copied, not moved.
  482.  
  483. Move             You  can  drag  specific icons  or  icons
  484.                  symbolizing a minimized window containing
  485.                  icons  to  a destination window with  the
  486.                  mouse.  Place cursor on icon, press  down
  487.                  the left mouse button, then drag the icon
  488.                  to  its destination and release the mouse
  489.                  button.
  490.  
  491.                  If  this  option is checked, the  icon(s)
  492.                  will  be  moved, not copied.  This  means
  493.                  that  the icon files in the source window
  494.                  will be deleted after copying. Icons from
  495.                  libraries (Exe/Dll/Nil/Icl) will  not  be
  496.                  deleted, but copied.
  497.                  If  the  source  window  is  empty  after
  498.                  moving  icons, you will be  prompted  for
  499.                  deletion of the directory.
  500.  
  501.                  Hint : Icons with identical names in  the
  502.                          source       and      destination
  503.                          directories will not  be  deleted
  504.                          because they will not be moved.
  505.  
  506.  
  507.  
  508. 5.2.2 Rename / Edit
  509.  
  510. You can also choose the processing of the current icon  in
  511. this menu:
  512.  
  513. Rename           If this option is checked, you can rename
  514.                  icons by a double clicking them with  the
  515.                  mouse or by pushing the Return key. Icons
  516.                  cannot  be renamed and moved at the  same
  517.                  time.
  518.  
  519.                  If  you  wish  to sort the icons  in  the
  520.                  current  window  after  the  renaming  is
  521.                  done, check the sort button.
  522.  
  523.                  You cannot rename icons in libraries.
  524.  
  525. Edit             If this option is checked, a double click
  526.                  with the mouse or the Enter key will  run
  527.                  the  command  under  "Edit  with..."   in
  528.                  Options  Menu  for the icon selected.  If
  529.                  the  editor chosen is capable of  command
  530.                  line  processing, the icon will be opened
  531.                  and displayed for further processing.  If
  532.                  not, you will still have to open the icon
  533.                  you wish to alter.
  534.  
  535. IcoShow  displays  the current choose  within  the  status
  536. line.
  537.  
  538.  
  539.  
  540. 5.2.3 Select
  541.  
  542. If  you check this command, a dialog box will be presented
  543. for  you  to  enter  a pattern to select  icons  from  the
  544. contents of the Current Window to be displayed exclusively
  545. (and  for  all other windows also). The pattern "A*"  lets
  546. display you and process only icons which names start  with
  547. the letter "A".
  548.  
  549. The  following  characters may  be  used  in  the  pattern
  550. string:
  551.  
  552.  Letter/digit/./_ normal characters, upper and lower  case
  553.                   are not distinguished
  554.  ?                any character
  555.  *                a number of any characters
  556.  []               a class of characters
  557.  ^                negates the class of characters in []
  558.  -                a range of characters in  []
  559.  
  560. Examples for pattern:
  561.  
  562.  A*               all  icons, starting with the  letter  A
  563.                   as ALPHA.ICO
  564.  A                same
  565.  
  566.  A[ABCDE]         all  icons  starting with the  letter  A
  567.                   followed by one of the letters A, B, C,
  568.                   D or E
  569.  A[A-E]           same
  570.  A[^F-Z]          also the same if only letters possible
  571.  
  572. Please  watch  out  for interactions  between  Select  and
  573. Exclude.
  574.  
  575.  
  576.  
  577. 5.2.4 Exclude
  578.  
  579. If  you check this command, a dialog box will be presented
  580. for  you  to  enter a pattern to exclude  icons  from  the
  581. displayed  contents  of the Current Window  (and  for  all
  582. other windows also). The pattern "A*" lets display you and
  583. process  only  icons  which names do not  start  with  the
  584. letter "A".
  585.  
  586. The  following  characters may  be  used  in  the  pattern
  587. string:
  588.  
  589.  Letter/digit/./_ normal characters, upper and lower  case
  590.                   are not distinguished
  591.  ?                any character
  592.  *                a number of any characters
  593.  []               a class of characters
  594.  ^                negates the class of characters in []
  595.  -                a range of characters in  []
  596.  
  597. Examples for pattern:
  598.  
  599.  A*               all  icons, starting with the  letter  A
  600.                   as ALPHA.ICO
  601.  A                same
  602.  
  603.  A[ABCDE]         all  icons  starting with the  letter  A
  604.                   followed by one of the letters A, B, C,
  605.                   D or E
  606.  A[A-E]           same
  607.  A[^F-Z]          also the same if only letters possible
  608.  
  609. Please  watch  out  for interactions  between  Select  and
  610. Exclude.
  611.  
  612.  
  613.  
  614. 5.3  Options Menu
  615.  
  616. Set options for IcoShow.
  617.  
  618.  
  619. 5.3.1 Edit with ...
  620.  
  621. Here  you  can  enter a command line to process  a  chosen
  622. icon.  Type  the complete command line to start  the  icon
  623. editor  of your choice without the icon's name. That  will
  624. be  added  when you double click the mouse  or  press  the
  625. Return  key  and  if  the Edit option  in  Icons  Menu  is
  626. checked.
  627. If   the   editor  chosen  is  capable  of  command   line
  628. processing,  the  icon will be opened  and  presented  for
  629. editing  automatically. If not, only the program  will  be
  630. started and you will have to open manually the icon to  be
  631. edited.  Further procedure depends upon the editor itself.
  632. Do not forget to save the changes made!
  633.  
  634. If  the  icon has been changed by the selected program, it
  635. will be reloaded and redisplayed on exit.
  636.  
  637.                   Hint  :  Do not use programs changing
  638.                            file structures on disks.
  639.  
  640.  
  641. 5.3.2 Repair Icons
  642.  
  643. Older icon files may contain bugs (the icon's upper border
  644. is  truncated). You can have repaired these icon files  by
  645. checking  this  option.  Bugs in  libraries  will  not  be
  646. removed.
  647. IcoShow will correct this bug always while running.
  648.  
  649.  
  650.  
  651. 5.3.3 Save Settings
  652.  
  653. If  you  check  this  option, IcoShow  saves  the  current
  654. settings  of  all options and the desktop on exit  in  the
  655. file ICOSHOW.INI in the IcoShow directory. If missing,  it
  656. will be created by IcoShow automatically.
  657.  
  658. Use  Alt-Shift-F4  to save all settings including  desktop
  659. while  IcoShow is running (in this case the  option  "Save
  660. Settings" should not be checked).
  661.  
  662.               Hint :   A change of this option will always
  663.                        be saved to the INI file on exit.
  664.  
  665.  
  666.  
  667. 5.3.4 Quick Delete
  668.  
  669. You normally delete icons with the Del key. After pressing
  670. this key you will be prompted if you really wish to delete
  671. the icon.
  672.  
  673. If  you  want  to  delete icons fast however,  check  this
  674. option. You can then delete icons simply by dragging  them
  675. out  of the screen. You will not be prompted, the icon  or
  676. all icons selected in the current window will be deleted!
  677.  
  678.  
  679.  
  680. 5.3.5 Quick Search
  681.  
  682. You  can find an icon by using the scroll bar or by cursor
  683. keys.  If you want to find an icon quickly by name,  check
  684. this  option.  You may then simply type  a  name  to  find
  685. matching  icons.  IcoShow will locate  these  and  display
  686. successively.  If  no icons answer to the  search,  string
  687. will be deleted automatically. Otherwise you will have  to
  688. delete it yourself.
  689.  
  690. You can use the following characters:
  691.  
  692.  Letters/digits/./_    normal characters
  693.  ?                stands for any single character
  694.  *                stands for any number of characters
  695.  Space            deletes the string
  696.  Backspace        deletes   the  last  character  in   the
  697.                   string
  698.  
  699. You can see the current entered string in the status line.
  700.  
  701.  
  702.  
  703. 5.4  Window Menu
  704.  
  705. Use this menu to arrange and size windows within IcoShow.
  706.  
  707. Cascade          If  you  activate this option, all opened
  708.                  windows within IcoShow will be shown as a
  709.                  Cascade.
  710.                  Hotkey:  Shift-F5
  711.  
  712. Tile             If  you  activate this option, all opened
  713.                  windows within IcoShow will be tiled. You
  714.                  can see all windows displayed now.
  715.                  Hotkey:  Shift-F4
  716.  
  717. Minimize Windows If  you  choose this command, all windows
  718.                  within  IcoShow  will  be  minimized  and
  719.                  arranged  in  alphabetic  order  at   the
  720.                  bottom  of  the IcoShow desktop.  If  you
  721.                  have   created  many  windows,  use  this
  722.                  command  and the command Maximize Windows
  723.                  to rearrange all windows.
  724.                  If   this   option   is  activated,   new
  725.                  directories,  respectively windows,  will
  726.                  be shown minimized.
  727.  
  728. Maximize Windows If you choose this command, all minimized
  729.                  windows will be shown in default size and
  730.                  arranged in alphabetic order according to
  731.                  the tile or cascade option.
  732.  
  733. Select Window    Within  the following dialog box you  can
  734.                  choose a window quickly and activate it.
  735.  
  736. Close All        Use   this  command  to  close  all  open
  737.                  windows  at  once. Upon  closing  IcoShow
  738.                  tries  to release a maximum of heap space
  739.                  and resources.
  740.  
  741. Arrange Icons    Choose   this  command  to  arrange   all
  742.                  minimized  windows at the bottom  of  the
  743.                  IcoShow  desktop  according  to  Windows'
  744.                  settings. The windows will not be  sorted
  745.                  by name.
  746.  
  747.  
  748.  
  749. 5.5  Help Menu
  750.  
  751. Look  here  for informations about registration,  ordering
  752. and  the  present  use  of heap and  resources.  For  more
  753. details about the dialog boxes see chapter 6.
  754.  
  755. Contents         Choose this menu command for the contents
  756.                  of  the  help index. If you need help  at
  757.                  any  place type the F1 key. IcoShow  will
  758.                  try to find the proper help for you.
  759.  
  760. How to use help  At this place you get the general Windows
  761.                  help.
  762.  
  763.  
  764. Registration     The author's hints for  registering  and
  765.                  how to contact him.
  766.  
  767.  
  768. Print Order Form  If you  wish  to  order  a  license  for
  769.                  IcoShow, you can fill in the form  online
  770.                  and  print it from here. Switch  on  your
  771.                  printer!
  772.  
  773.                  After  printing the form is not saved  to
  774.                  disk. After you pressed the OK button you
  775.                  will  have  to fill it in anew  to  print
  776.                  another copy.
  777.  
  778. Set Register Information   After you register the program,
  779.                  you  can input your name and the received
  780.                  password in the following dialog box.  If
  781.                  the password contains spaces, please type
  782.                  the spaces too.
  783.                  IcoShow writes the informations into  INI
  784.                  file  and stores them under "Registered="
  785.                  and "Password=". The password will not be
  786.                  checked to this time!
  787.  
  788. About IcoShow    Use  this  to  display  informations   on
  789.                  copyright and the present use of heap and
  790.                  resources.
  791.  
  792.  
  793.  
  794. 5.6  Properties Menu
  795.  
  796. If  you  click  on  an icon with the right  mouse  button,
  797. IcoShow displays the properties Menu. In this menu you can
  798. select  another image if the icon has more than  one.  You
  799. can select the properties available for this icon, such as
  800. exclude,   delete,  edit  or  rename.  Only  the  possible
  801. Properties  will  be  displayed. In example  the  property
  802. "rename" is not available if you click on an icon  from  a
  803. library.
  804. Last but not least you can change the options to determine
  805. the function of the left mouse button.
  806.  
  807. IcoShow  tries  to  position the  proper  image  near  the
  808. current icon. Click on the image which you wish to use for
  809. further  processing. Note that you can  display  only  one
  810. image from an icon at any time. If IcoShow copies to  icon
  811. files,  it  will be copied all images. You can  choose  to
  812. write all images if you write icons into a library.
  813.  
  814. Exlude Icon      Choose this option if you wish to exclude
  815.                  the current icon from further processing.
  816.                  You  can  select this icon again  if  you
  817.                  change  the criteria for selecting and/or
  818.                  excluding  icons  (Select/Exclude  within
  819.                  Icons MenuIconMenu) or if you choose  the
  820.                  menu point Refresh from File Menu!
  821.  
  822. Delete Icon      Choose  this option if you wish to delete
  823.                  icons  from  disk too. You cannot  delete
  824.                  icons  from  libraries.  These  will   be
  825.                  deleted from display only.
  826.  
  827. Rename Icon      If  you  choose this option, you will  be
  828.                  prompted for a new name of the icon.  You
  829.                  cannot   rename   icons  from   libraries
  830.                  directly, however.
  831.  
  832.                  Check the  "Sort" box if you wish to sort
  833.                  the  display in the current window  after
  834.                  renaming. The icon will be displayed then
  835.                  at  its  proper place within  the  window
  836.                  according to its new name.
  837.  
  838. Edit Icon        If  you choose this option, IcoShow  will
  839.                  run the program from "Edit with".
  840.  
  841. Copy             You  can  drag  specific icons  or  icons
  842.                  symbolizing a minimized window containing
  843.                  icons  to  a destination window with  the
  844.                  mouse.  Place cursor on icon, press  down
  845.                  the left mouse button, then drag the icon
  846.                  to  its destination and release the mouse
  847.                  button.
  848.                  If  this  option is checked, the  icon(s)
  849.                  will be copied, not moved.
  850.  
  851. Move             You  can  drag  specific icons  or  icons
  852.                  symbolizing a minimized window containing
  853.                  icons  to  a destination window with  the
  854.                  mouse.  Place cursor on icon, press  down
  855.                  the left mouse button, then drag the icon
  856.                  to  its destination and release the mouse
  857.                  button.
  858.  
  859.                  If  this  option is checked, the  icon(s)
  860.                  will  be  moved, not copied.  This  means
  861.                  that  the icon files in the source window
  862.                  will be deleted after copying. Icons from
  863.                  libraries (Exe/Dll/Nil/Icl) will  not  be
  864.                  deleted, but copied.
  865.                  If  the  source  window  is  empty  after
  866.                  moving  icons, you will be  prompted  for
  867.                  deletion of the directory.
  868.  
  869.                  Hint : Icons with identical names in  the
  870.                          source       and      destination
  871.                          directories will not  be  deleted
  872.                          because they will not be moved.
  873.  
  874. Rename           If this option is checked, you can rename
  875.                  icons by a double clicking them with  the
  876.                  mouse or by pushing the Return key. Icons
  877.                  cannot  be renamed and moved at the  same
  878.                  time.
  879.                  If  you  wish  to sort the icons  in  the
  880.                  current  window  after  the  renaming  is
  881.                  done, check the sort button.
  882.                  You cannot rename icons in libraries.
  883.  
  884. Edit             If this option is checked, a double click
  885.                  with the mouse or the Enter key will  run
  886.                  the  command  under  "Edit  with..."   in
  887.                  Options  Menu  for the icon selected.  If
  888.                  the  editor chosen is capable of  command
  889.                  line  processing, the icon will be opened
  890.                  and displayed for further processing.  If
  891.                  not, you will still have to open the icon
  892.                  you wish to alter.
  893.  
  894.  
  895.  
  896. 6. Dialog Boxes
  897.  
  898. 6.1  Open
  899.  
  900. Add  a new window (or new windows) with the icons existing
  901. in  a given directory. The dialog box allows you to browse
  902. for   the   directory   wanted  and   to   check   whether
  903. subdirectories  and/or  icon libraries  (...)  are  to  be
  904. included  and whether IcoShow is to look for  and  display
  905. icon names found in some libraries.
  906.  
  907. Drives and Directories  Browse for the  name  of  a  drive
  908.                  and/or directory or enter it in the  list
  909.                  box below. If you click the OK button  or
  910.                  press  the Return key, processing of  the
  911.                  directory will start.
  912.  
  913. Subdirectories   Select  this option if you wish  to  look
  914.                  for  icons in subdirectories of the  main
  915.                  directory  or  drive  chosen,  too.  Each
  916.                  directory containing icons will be  shown
  917.                  as  a separate window.
  918.  
  919. Libraries        Check this box if you want to search  for
  920.                  icons included in library files, too. You
  921.                  may   check   all  types   of   libraries
  922.                  supported  (Exe/Dll/Nil/Icl)  or   select
  923.                  specific ones.
  924.  
  925. Search for Names Many icon libraries include names for the
  926.                  icons. If you wish to display those names
  927.                  along with the icons, check this box.
  928.  
  929.                  If this option has not been checked or if
  930.                  there are no names assigned to the icons,
  931.                  the library's name is used, suffixed by a
  932.                  running number.
  933.  
  934.  
  935.  
  936. 6.2  Print Icons
  937.  
  938. This  dialog box will open after you have issued the Print
  939. Icons command in the File Menu.
  940. By  checking the print names box you will have  the  names
  941. assigned  to  the  icons  printed along  with  the  design
  942. itself.
  943.  
  944. If printer initialisation is succesful, the next dialog box
  945. will be displayed. Press the Cancel button if you wish  to
  946. cancel the printing.
  947.  
  948.  
  949.  
  950. 6.3  Create Library
  951.  
  952. In  this  dialog box you can set the options to  create  a
  953. library.  If  the  library already  exists,  you  will  be
  954. prompted to delete it before you go on.
  955. IcoShow can put over 2,700 icons (images) in a single icon
  956. library. But if you want to use the library later with the
  957. program  manager, you should not include more  than  1,200
  958. icons (images). IcoShow will issue a warning.
  959. Only  the  icons selected will be written to the  library.
  960. Please  check Select/Exclude in Icons Menu to see if  your
  961. choice corresponds with your intentions.
  962.  
  963. Library Name    Enter  the  name  of the library  in  this
  964.                 field  or  select  it from  the  list  box
  965.                 below.
  966.  
  967.                 Default name for the library is ICONS.DLL.
  968.                 IcoShow  will write the last name used  to
  969.                 the  INI  file if you have selected  "Save
  970.                 Settings" in the Option Menu.
  971.  
  972. Library Type    Choose  the  type of library you  wish  to
  973.                 create  here. Supported are DLL,  NIL  and
  974.                 ICL files.
  975.  
  976. Current Only    Check  this box if you wish to write  only
  977.                 the icons in the current window.
  978.  
  979. Selected Only   Check  this box if you wish to write  only
  980.                 the icons in the windows selected. You can
  981.                 select these windows in the "Select Window
  982.                 Dialog Box" from Window Menu.
  983.  
  984. All Windows     Check  this box if you wish to  write  all
  985.                 the icons selected from all windows.
  986.  
  987. Sort            Check this box to write all icons selected
  988.                 in  alphabetic order. If this box  is  not
  989.                 checked,   the  icons  will   be   written
  990.                 successively.
  991.  
  992.                 IcoShow sorts the pathnames of the windows
  993.                 in alphabetic order, ascend if windows are
  994.                 minimized  and  descend  if  windows   are
  995.                 maximized  or  normally  shown  (see  also
  996.                 "Minimize Windows" and "Maximize  Windows"
  997.                 under Window Menu).
  998.  
  999. Write Names with Icons    Check this box to write icons to
  1000.                 the  library  including  their  names.  If
  1001.                 icons  have  no names, IcoShow will  build
  1002.                 names  using up to 5 characters  from  the
  1003.                 library's  name  and a 3  character  index
  1004.                 including  only letters and digits  (46656
  1005.                 variants).
  1006.  
  1007. Exclude Duplicates   Check this box to instruct IcoShow to
  1008.                 compare   all   icons   and   to   exclude
  1009.                 duplicates  from  all  the  icons  to   be
  1010.                 written to the library.
  1011.  
  1012.                 You  can use this possibility to eliminate
  1013.                 duplicate  icons from your directory  even
  1014.                 if you want them as .ICO-files.  Write all
  1015.                 icons  to  a  library while  this  box  is
  1016.                 checked,  delete  icon files  and  extract
  1017.                 them from the library again.
  1018.  
  1019. Write all Images Some icons include more than one image for
  1020.                 displays with different numbers of colors.
  1021.                 Normally  the  image  selected  for   your
  1022.                 display will be written to the library. If
  1023.                 this  box  is checked, IcoShow will  write
  1024.                 all  images  to  the  library.  That  will
  1025.                 minimize the number of stored icons!
  1026.  
  1027. If  you overwrite an old library, you need disk space  for
  1028. both the old and the new version.
  1029.  
  1030.  
  1031.  
  1032. 6.4  Select Icons
  1033.  
  1034. In  this  dialog  box you can enter the  pattern  used  to
  1035. select  icons  for  processing.  For  more  details  about
  1036. pattern see chapter 5.
  1037.  
  1038.  
  1039.  
  1040. 6.5  Exclude Icons
  1041.  
  1042. In  this  dialog  box you can enter the  pattern  used  to
  1043. exclude  icons  from  processing. For more  details  about
  1044. pattern see chapter 5.
  1045.  
  1046.  
  1047. Please  watch  out  for interactions  between  Select  and
  1048. Exclude.  You can write patterns in the INI file  manually
  1049. to  select/exclude icons while IcoShow  is  starting.  All
  1050. patterns  you  have entered while IcoShow is running  will
  1051. not be written to INI file!
  1052.  
  1053.  
  1054.  
  1055. 6.6  Edit with ...
  1056.  
  1057. In  this dialog box you can enter the command line used to
  1058. start  icon processing, usually the complet path to  start
  1059. the icon editor of your choice. The name of the icon to be
  1060. edited  will be added when the command is issued,  so  the
  1061. editor  will  open with the icon already  displayed.  This
  1062. will  work  only if the editor is capable of command  line
  1063. processing.
  1064.  
  1065.  
  1066.  
  1067. 6.7  Rename Icon
  1068.  
  1069. In  this  dialog  box you can enter a  new  name  for  the
  1070. selected  icon.  You  cannot rename icons  from  libraries
  1071. directly, however.
  1072.  
  1073. Sort            Check the  "Sort" box if you wish to  sort
  1074.                 the  display  in the current window  after
  1075.                 renaming. The icon will be displayed  then
  1076.                 at  its  proper  place within  the  window
  1077.                 according to its new name.
  1078.  
  1079.  
  1080. 6.8  Select Window
  1081.  
  1082. This  dialog box will help you to select a window  quickly
  1083. or  to  calculate the number of icons which  you  wish  to
  1084. write to a library. Use the Shift key to select more  than
  1085. one window.
  1086. If  only  one  window is highlighted this window  will  be
  1087. activated  if  you press the Enter key  or  click  the  OK
  1088. button.
  1089.  
  1090.  
  1091.  
  1092. 6.9  Registration
  1093.  
  1094. You will get familiar with this dialog box if you have not
  1095. registered by December 31st, 1992.
  1096.  
  1097.  
  1098.  
  1099. 6.10 Print Order Form
  1100.  
  1101. In  this dialog box you may fill in the text for the order
  1102. form. Printing starts after the print button was clicked.
  1103.  
  1104. After  printing the form is not saved to disk.  After  you
  1105. pressed the OK button you will have to fill it in anew  to
  1106. print another copy.
  1107.  
  1108. If  you  are not from Germany and you pay using  check,  I
  1109. must add the price to cash the check.
  1110.  
  1111. If you fill in the EMail address (or the network path),  I
  1112. will  send  you  a message after I have a new  version  on
  1113. CompuServe.
  1114.  
  1115. Please  use payment per VISA if you are not from  Germany.
  1116. If  you  decide  to do so, IcoShow displays the  following
  1117. dialog  box  to  prompt you for the Card  Number  and  the
  1118. Release Date:
  1119.  
  1120. Enter the correct Card Number and the Release Date of your
  1121. VISA  Card. IcoShow checks your entries and will not allow
  1122. you to enter incorrect statements.
  1123. If  you  wish to change a correct credit card number,  you
  1124. must  first  close the dialog box "Print Order Form"  with
  1125. the OK button and open it again.
  1126.  
  1127.  
  1128.  
  1129. 6.11 About IcoShow
  1130.  
  1131. Here  are copyright messages and some informations on heap
  1132. and resources used.
  1133.  
  1134. "Free Heap"    shows  you the minimum of local and  global
  1135.                heap. That will be sure the minimum of  the
  1136.                local heap.
  1137.  
  1138. "Free Resources"     shows  you the minimum of  the  local
  1139.                heap from User and GDI.
  1140.  
  1141. "Processed Icons"    shows  you the amount of  icons  read
  1142.                overall.
  1143.  
  1144. Check  these informations. If you see that "Free Heap"  is
  1145. very  small, close windows to free local heap. An overflow
  1146. in local heap stops IcoShow immediately.
  1147.  
  1148. If  there  are no more windows or dialog boxes  displayed,
  1149. you have too many opened windows.
  1150.  
  1151.  
  1152.  
  1153. 7. Status Line
  1154.  
  1155. The standard status line offers the following informations:
  1156.  
  1157. Status of the Status     of Number      of Number     of
  1158. menu commands the      menu icons     read icons      in
  1159. Copy  /  Move command       and   selected current
  1160. within    the Rename      / and        the window.
  1161. Icons Menu.   Edit   within number      of
  1162.               the     Icons opened
  1163.               Menu.         windows.
  1164.  
  1165.  
  1166.  
  1167. If  the option "QuickSearch" in Icons Menu is checked  and
  1168. you  have entered a search string, the status line  offers
  1169. the following informations:
  1170.  
  1171. Status of the Status     of Number      of Entered
  1172. menu commands the      menu icons     read Substring.
  1173. Copy  /  Move command       and   selected
  1174. within    the Rename      / and        the
  1175. Icons Menu.   Edit   within number      of
  1176.               the     Icons opened
  1177.               Menu.         windows.
  1178.  
  1179.  
  1180.  
  1181.  
  1182. 8. Hints for the use of IcoShow
  1183.  
  1184. Here  are  some  hints about the (more) effective  use  of
  1185. IcoShow:
  1186.  
  1187.    1.     If  you  install ICO files into program manager,
  1188.      create   a  directory  where  you  save  this   files
  1189.      together. Than you can see all at once.
  1190.    
  1191.    2.     If  you plan to copy or move many icons,  create
  1192.      a  temporary directory and copy the icons there. This
  1193.      does  not  take a long time and you have  been  saved
  1194.      your  icons if you make a mistake. If you are  ready,
  1195.      delete the directory with the icons.
  1196.    
  1197.    3.     Be  careful to install icons to program  manager
  1198.      if  there are bad program icons especially in windows
  1199.      3.0.  Because  errors in this case will not  reported
  1200.      from  IcoShow  but from the program  manager  Windows
  1201.      could  hang. If that happened, try to use Alt-ESC  to
  1202.      change to the task manager and then back to IcoShow.
  1203.    
  1204.    4.  If  you install icons while Norton Desktop (version
  1205.      1.0)  is  running, install only icon  files.  Because
  1206.      there  is  a  bug in Norton's task manager  the  heap
  1207.      space will be lost if you install icons from a dll.
  1208.    
  1209.    5.     If  you wish to use another background color for
  1210.      your  icons, then load control panel and  select  the
  1211.      color.  Then write the RGB values into the  INI  file
  1212.      of IcoShow under BackColor (see upon).
  1213.    
  1214.    6.     Icons  or all icons selected in a window can  be
  1215.      deleted  by  the  DEL  key (you cannot  delete  icons
  1216.      within  libraries). If you are an  experienced  user,
  1217.      you  can  delete them simple by dragging them outside
  1218.      of  screen. Choose "QuickDelete" from Options Mene to
  1219.      do  so.  Please be careful because IcoShow  does  not
  1220.      undelete icons!
  1221.    
  1222.    7.       Please    note    the    difference    between
  1223.      "QuickSearch"   and   the   options   "Select"    and
  1224.      "Exclude".  QuickSearch navigates only  to  a  proper
  1225.      symbol   in   current  window  while   Select/Exclude
  1226.      chooses  the  icons for display and  process  in  all
  1227.      windows.
  1228.    
  1229.    8.      If   you   get   the   message   "Overflow   in
  1230.      local/global  heap",  close  windows   or   work   in
  1231.      enhanced mode.
  1232.      If  you   get   the  message  "No  more   space   for
  1233.      resources", IcoShow will not exit rather  than  icons
  1234.      will   be   displayed  as  question  marks.  Minimize
  1235.      windows to free resources.
  1236.    
  1237.  
  1238.  
  1239. 9. Shareware Version
  1240.  
  1241. You  can  use the not registered version of IcoShow  until
  1242. December,  31st 1992 for evaluation. Please do  not  patch
  1243. the program and especially do not change my name.
  1244.  
  1245. If  you  register the program for $35, I will send  you  a
  1246. printed documentation.
  1247.  
  1248. If you need support, write me a letter to my address below
  1249. or send me a fax or mail. I will try to help you anyway.
  1250.  
  1251.  
  1252.  
  1253. My address :     Harald Pitro
  1254.                  Hermann-Wuensche-Strasse 11
  1255.                  Germany - O - 8705 Ebersbach / Sachsen
  1256.  
  1257. Mail to:         Phone/Fax   +49-3586-5186
  1258.                  CompuServe  100024, 2662
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264. Ebersbach September, 28th 1992
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.                                      Harald Pitro
  1272.  
  1273.